home *** CD-ROM | disk | FTP | other *** search
/ PC-Blue - MS DOS Public Domain Library / PC-Blue MS-DOS Public Domain Library - NYACC.iso / vol309 / jdutil.arc / UTIL.DOC < prev    next >
Encoding:
Text File  |  1986-09-08  |  6.1 KB  |  114 lines
  1.      MSDOS UTILITIES BY JON DART - 09-SEP-86
  2.  
  3.        This  disk  contains  a  collection  of  utility programs, including
  4.      several which mimic the operation of unix (tm) commands.
  5.  
  6.        All of these programs require MSDOS2 or 3.  SHOW assumes  that  your
  7.      computer is IBM-compatible at the BIOS level (it can be reassembled to
  8.      produce a  "generic  MSDOS"  version).  LS is supplied in both generic
  9.      and PC-dependent versions.  The other programs are not at all machine-
  10.      specific and should run on any MSDOS system.
  11.  
  12.        LS displays a sorted directory with file sizes.  There  are  several
  13.      such  programs  in  the public domain, but all of the ones I have seen
  14.      have deficiencies--they are too big, too slow,  don't  show  the  disk
  15.      free space,  can't display system files, and/or use tricks that render
  16.      them unusable on my computer, which is NOT a perfect IBM clone.  LS is
  17.      designed to be easily adaptable to any "generic MSDOS" system, with at
  18.      most minor modifications.  There are two executable files on the disk:
  19.      LS.EXE is "generic", and LS-PC.EXE is for IBM PCs and clones or  near-
  20.      clones that recognize IBM BIOS calls.
  21.  
  22.        To display  system  and hidden files, type "LS -A".  To get a "long"
  23.      listing with times and dates, type "LS -L".
  24.  
  25.        HEAD and TAIL are simple filters that display a few lines  from  the
  26.      start or the end of a file, respectively. The general syntax for these
  27.      programs is:
  28.  
  29.        HEAD -n filename
  30.  
  31.        n  is  the  number of lines to display: e.g. "HEAD -50 FOO" displays
  32.      the first 50 lines of "FOO". The default number of lines  is  20;  the
  33.      maximum that can be specified is 65535. If no input file is specified,
  34.      HEAD reads  from  the  standard  input, so it can be hooked to another
  35.      program's output via a pipe. TAIL is used similarly.
  36.  
  37.        WC is a utility to count bytes, words and lines in a file. Like HEAD
  38.      and TAIL, it defaults to the  standard  input  if  no  input  file  is
  39.      specified on the command line.
  40.  
  41.        SHOW  is my adaptation of a CP/M bidirectional file display program.
  42.      It shows a file on the screen, and allows you to  scroll  forward  and
  43.      backwards.  If  all you want to do is see the file, this is often more
  44.      convenient than calling up your editor. Unlike TYPE, SHOW will display
  45.      WordStar (tm) and WordPerfect (tm) files  in  more  or  less  readable
  46.      format. Type SHOW with no arguments to get instructions.
  47.  
  48.        MV  is  a  general-purpose  program  to  move  files and directories
  49.      between disks and directories.  It is similar to the UNIX (tm) utility
  50.      of the same  name.    With  the  R  switch,  MV   treats   directories
  51.      recursively: that  is,  if  it  is  told  to move a directory, it will
  52.      transfer all files found in that  directory,  AND  all  files  in  any
  53.      subdirectories of it.  Type MV with no arguments to get instructions.
  54.  
  55.        CP  is  virtually  the  same  as  MV, except that it copies files or
  56.      directories, without deleting the originals. Type CP with no arguments
  57.      to get instructions.
  58.  
  59.        RM deletes files and/or directories.  It is similar to the MSDOS DEL
  60.      command, but allows multiple files to be  specified,  and  supports  a
  61.      number  of  options.    Type RM with no arguments to get instructions.
  62.      CAUTION: the F and R switches are potentially dangerous.  Be sure  you
  63.      know  what  you are doing before you use them; if in doubt, experiment
  64.      on a "junk" disk first.
  65.  
  66.        RO is a utility to make one or more file read-only. Files  that  are
  67.      set "read-only"  cannot  be  deleted by the ordinary MSDOS DEL command
  68.      (it will respond "File not found" if you  try  this).  They  are  also
  69.      protected  from    deletion  by the RM program (unless the F switch is
  70.      used).  Type RO to get  instructions.
  71.  
  72.        RW is a utility to restore one or more  files  that  have  been  set
  73.      read-only back   to   ordinary   read-write   status.   Type   RW  for
  74.      instructions.
  75.  
  76.        CRC computes a cyclic redundancy code for one or  more  files.    It
  77.      writes  the crc list to the standard output--it can be redirected into
  78.      a file if you so desire.  Users of Aztec C should note that  this  CRC
  79.      utility is different from the one that comes with the Aztec C develop-
  80.      ment  system,  and  gives incompatible  results (it is compatible with
  81.      XMODEM).
  82.  
  83.        UPDATE is similar to the unix "touch" utility.  It sets the time and
  84.      date of one or more files to the current system time and date.    Type
  85.      UPDATE with no arguments for instructions.
  86.  
  87.        FDUMP  is  a simple utility for viewing and patching files in ASCII,
  88.      hex, decimal or octal.  It displays a command menu when it is run.
  89.  
  90.      -------------
  91.        Notes on the source code: LS, HEAD, TAIL, MV,  CP,  RM  and  WC  are
  92.      written in assembly language and were assembled with MASM 4.0.  All of
  93.      these programs  must  be linked with ASM.LIB.  The source code for the
  94.      modules in ASM.LIB is in ASM.ARC.  ASM.ARC also contains some  include
  95.      files needed for assembling the programs.
  96.  
  97.        RO,  RW,  CRC,  UPDATE  and  FDUMP  are written in Aztec C, and were
  98.      compiled in  the  "small  model"  mode  using  version  3.20e  of  the
  99.      optimizing compiler.   They  must be linked with the library B.LIB and
  100.      with the standard Aztec library C.LIB (in  that  order).    Note  that
  101.      B.LIB is in  Aztec,  not Microsoft, format.  B.ARC contains the source
  102.      for the object modules in B.LIB, and also some header  files  used  by
  103.      the c programs.
  104.  
  105.        These  programs  are  PUBLIC  DOMAIN and may be freely copied, used,
  106.      modified, etc. for ANY purpose  (the  one  thing  you  probably  can't
  107.      legally do  is  to  copyright  them  yourself).    I  don't  offer any
  108.      guarantee of support for them, but I will generally fix bugs that  are
  109.      reported to me.   Any comments, complaints, bug reports or suggestions
  110.      for improvement should be sent to: Jon Dart, 6067  Carnegie  St.,  San
  111.      Diego, CA 92122.
  112.  
  113.  
  114.